home *** CD-ROM | disk | FTP | other *** search
/ The Very Best of Atari Inside / The Very Best of Atari Inside 1.iso / sharew / accs / dtmt_ste / dtmt.txt < prev    next >
Encoding:
Text File  |  1993-04-30  |  12.9 KB  |  333 lines
  1.  _______________________________________________
  2. |Program:       DeskTracker MultiTask           |
  3. |Type:          Accessory                       |
  4. |Version:       s 1.00                          |
  5. |Distribution:  Shareware                       |
  6. |System:        STe/TT/Falcon*;                 |
  7. |               not MultiTOS*                   |
  8. |               any ST screen rez               |
  9. |Last update:   22nd April 1993                 |
  10. |Written by:    David Oakley, original tracker  |
  11. |               playing routine by WizCat       |
  12. |                                               |
  13. |Copyright ©1991 Wizzcat (Tracker player only), |
  14. |          ©1992,1993 ASTRAsoft                 |
  15. |                                               |
  16. |Purpose:       Play NoiseTracker modules in    |
  17. |               the background with animated    |
  18. |               graphic display of tune.        |
  19.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  20. Based on a NoiseTracker player routine written by Wizzcat in 1991, 
  21. DeskTracker and the current version (DeskTracker MT) are designed to play 
  22. MOD files on any machine with PCM sound chip.
  23.  
  24. NOTE: ON SOME MACHINES AND SETUPS THE COMPLICATED NATURE OF DESKTRACKER'S 
  25. MODULE PLAYER MAY CAUSE A CRASH IF EXPOSED TO TOO HEAVY WORKLOAD DURING 
  26. HIGH-SPEED PLAYBACK. EXPERIMENT FOR A WHILE BEFORE DOING IMPORTANT THINGS 
  27. WHILE RUNNING DTMT!!!!!
  28.  
  29.  __________________
  30. / Compatibility * /
  31. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  32. DeskTracker will only run on an ST compatible that supports Atari's PCM 
  33. sound which was first introduced on the STe. We have tested DtMt on an 
  34. 1040STe, Mega/STe 4 and a Falcon. On the Falcon we failed to get any 
  35. sound out, though DeskTracker reported that it was playing correctly. I 
  36. think it's something to do with setting up sound channels and you may be 
  37. able to do better. Last time we tried it on MultiTOS (OK, the only time) 
  38. it didn't work. You never know it might now - I'm sure somebody will tell 
  39. me.
  40.  
  41. Since it ran on a Falcon, we are confident that it should run on a TT or 
  42. upgraded STe using an 030.
  43.  
  44.  ____________
  45. / The files /
  46. ¯¯¯¯¯¯¯¯¯¯¯¯
  47. In this package (archive or folder) you should find the following files:
  48.  
  49.         DTMT.ACC        The GEM interface. Can also be run as a program.
  50.  
  51.         DTMTTRAK.PRG    The Tracker module. Put in your AUTO folder or
  52.                         run before first accessing DTMT.ACC
  53.  
  54.         DTMT.TXT        This file
  55.  
  56.  __________________
  57. / Getting started /
  58. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  59. Just copy DTMTC.ACC into the root of your boot drive (e.g. A:\ or C:\),
  60. and ATRAK.PRG into your AUTO folder. Just in case you're wondering about 
  61. putting a new program in the AUTO folder of your hard drive, don't worry! 
  62. On first running, ATrak only sets itself up a Cookie and then stays 
  63. resident. It doesn't attempt to play any Tracker tunes!
  64.  
  65.  ____________
  66. / Operation /
  67. ¯¯¯¯¯¯¯¯¯¯¯¯
  68. DeskTracker is designed to work just like a real CD player. Well, it works
  69. like mine does. It has two main modes of operation: normal and memory.
  70. When in Memory mode, several of the buttons have different meanings, usually
  71. when no MOD is being played.
  72.  
  73. In the list below, shortcut keys are in square brackets (eg. [E] ).
  74.  
  75. Click on the menu item 'DeskTracker MTc' in the File menu. The DeskTracker 
  76. window will appear:
  77.  
  78.  ________________________________________
  79. |X|         DeskTracker MTc            |O|
  80. |----------------------------------------|
  81. |___________Version_1.20________|iii|~~~~|
  82. | ____ ____ ____  ____          ¯¯¯¯¯¯¯¯¯|
  83. || /\ | [] | |> || 00 |    ASTRAsoft  |06|
  84. ||====|====|====||----| ____ ____ ____|12|
  85. || << | || | >> ||<=> ||MEM |ADD |RAND|25|
  86. | ¯¯¯¯ ¯¯¯¯ ¯¯¯¯  ¯¯¯¯  ¯¯¯¯ ¯¯¯¯ ¯¯¯¯|50|
  87.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  88.  
  89. What the buttons do:
  90.  
  91. Button  Display  Description
  92.  
  93. Close            If in Accessory mode, closes the window but keep playing.
  94. [Undo]           If in Program mode, stops playing and quits the program.
  95.  
  96. Full             Iconises DeskTracker to a very small window. All keyboard
  97.                  shortcuts still work and operation continues as normal.
  98.                  Useful for MultiTOS.
  99.          ______
  100. Eject   |  /\  | Load and start a new NoiseTracker MODule. If you press
  101. [E]     |  ==  | Cancel on the fileselector then the current tune is
  102.          ¯¯¯¯¯¯  erased from memory and the memory is freed.
  103.          ______
  104. Stop    | |¯¯| | Stop the currently playing song, but don't erase it
  105. [S]     | |__| | from memory. Reset pointers to start of song.
  106.          ¯¯¯¯¯¯
  107.          ______
  108. Play    |  |\  | Play the current song from the current position. If any
  109. [Spc]   |  |/  | other program has stoped DeskTracker, this will restart
  110.          ¯¯¯¯¯¯  the tune from where it was stopped.
  111.         _______
  112. Pause  | |¯|¯| | Stop the currently playing song, but remember where
  113. [P]    | |_|_| | we were so play restarts from this point.
  114.         ¯¯¯¯¯¯¯
  115.          ______
  116. Rewind  | /|/| | Move the play position back by one section
  117. [,]     | \|\| |
  118.          ¯¯¯¯¯¯
  119.          ______
  120. Fast    | /|/| | Move the play position forward by one section
  121. Forward | \|\| |
  122. [.]      ¯¯¯¯¯¯
  123.          ______
  124. Add to  | ADD  | Select a MOD file and add it to the end of the
  125. memory  |      | playlist
  126. [+]      ¯¯¯¯¯¯
  127.          ______
  128. Memory  | MEM  | Shown depressed when songs are in memory
  129. On      |      | Click to deselect and clear the memory 
  130. [M]      ¯¯¯¯¯¯
  131.          ______
  132. Repeat  | +->+ | Toggles whether the MOD file will repeat once it
  133. [R]     | +<-+ | has reached the end. DtMt will even trap those MOD
  134.          ¯¯¯¯¯¯  files which will normally always loop!
  135.          ______
  136. Oscillo |\/\/\/| Opens the oscilloscope window.
  137. [O]      ¯¯¯¯¯¯
  138.          ______
  139. Anim    |IIIIII| Opens the animation window and then toggles between
  140. [A]      ¯¯¯¯¯¯  the three representations.
  141.            __
  142. Frequency |06|   These buttons select what the output frequency
  143. Selectors |12|   of the player is through the STe's PCM sound
  144. [1..4]    |25|   generator. Higher frequency means better quality
  145.           |50|   but more processor time. 50 will lock an 8MHz
  146.            ¯¯    computer!!!
  147.  
  148.  _____________
  149. | Memory Mode |
  150.  ¯¯¯¯¯¯¯¯¯¯¯¯¯
  151. Once the ADD function has been used to move into Memory mode, several of 
  152. the buttons change:
  153.  
  154. Button  Display  Description
  155.          ______
  156. Eject   |  /\  | Stops and unloads the current song, and resets to
  157. [E]     |  ==  | the start of the playlist.
  158.          ¯¯¯¯¯¯  
  159.          ______
  160. Stop    | |¯¯| | Stops and unloads the currently playing song.
  161. [S]     | |__| | 
  162.          ¯¯¯¯¯¯
  163.          ______
  164. Play    |  |\  | Plays the current song from the current position.
  165. [Spc]   |  |/  | Loads the current song if it is not in memory.
  166.          ¯¯¯¯¯¯  
  167.         _______
  168. Pause  | |¯|¯| | Stop the currently playing song, but remember where
  169. [P]    | |_|_| | we were so play restarts from this point.
  170.         ¯¯¯¯¯¯¯
  171.          ______
  172. Rewind  | /|/| | Rewind through the current song if PLAYing
  173. [,]     | \|\| | or move to the previous song in the playlist.
  174.          ¯¯¯¯¯¯
  175.          ______
  176. Fast    | /|/| | Speed forward through the current song if PLAYing
  177. Forward | \|\| | or move to the next song in the playlist.
  178. [.]      ¯¯¯¯¯¯
  179.          ______
  180. Repeat  | +->+ | Toggles whether the playlist will repeat once all
  181. [R]     | +<-+ | songs have been played. Songs will never repeat when
  182.          ¯¯¯¯¯¯  in Memory mode.
  183.          ______
  184. Random  | RAND | Play items in the playlist in a random order. Currently
  185. play    |      | tracks may repeated before all tracks have played.
  186.          ¯¯¯¯¯¯  Effectively turns on Repeat mode.
  187.  
  188.  ______________________
  189. / DeskTracker History /
  190. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  191.  
  192. The core song player in DeskTracker is based on Replay STe, a Tracker
  193. player written by Wizzcat in May 1991. Work on the GEM interface 
  194. began in April '92 when I got my Mega/STE... a working version of it
  195. was completed in three weeks!
  196.  
  197. DeskTracker was written in GFABASIC 3.5 and provided a dialog box interface,
  198. but it did look quite like the version you see here. After a year of work
  199. I've added a lot and refined a lot. Don't be deceived by its relatively
  200. small size - I'd call it finely chizelled artwork!
  201.  
  202. This version is written in Lattice C 5.52 and DevPac 2. I really do recommend
  203. Lattice to anyone who is serious about Atari software production in the
  204. future... if Atari Corp use it I'd say that's a pretty good guarantee of
  205. its longevity.
  206.  
  207.  
  208. The major changes to the original program were:
  209.  
  210.   o  conversion of DeskTracker into a window
  211.      (when it became DeskTracker MT),
  212.      
  213.   o  moving the animation bars into a separate window,
  214.   
  215.   o  adding memory functions, 
  216.   
  217.   o  allowing the user to change play frequency at any time
  218.   
  219.   o  DtMt can read in ICE packed MOD files as created by using the DATA
  220.      pack in JAM Packer 4.0
  221.      
  222.   o  Load and decompress a new song while the previous one is playing
  223.   
  224.   o  Realtime oscilloscope in a GEM window
  225.   
  226.   o  Information bar
  227.   
  228.   o  Iconise DtMt by clicking on the Full-box
  229.   
  230.   o  Load old 15-sample type MOD files
  231.  
  232.  ___________________
  233. / Revision History /
  234. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  235. Date            Version Comments
  236. 26/04/93        1.00    First released version
  237. 28/04/93        1.01    ACC now installs correctly;
  238.                                         animation bars didn't run(fixed);
  239.                                         alert informing user that Trak wasn't running
  240.  
  241.  _____________________________________
  242. / And the thanks and hellos go to... /
  243. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  244.  People who helped in the development of the DeskTracker project
  245.  (whether they knew it or not...!)
  246.  
  247.  Fozz, R.T.D., Had, Ian R., Wizzcat, 4-mat, U4ia
  248.  
  249.  And the hello list in alphabetical order...
  250.  
  251.  Ant, Andy-O., Fez(and his amazing technicolour hair), Fozz,
  252. Had(watch out for Fire, world!), Ictari, imr, Ian-S., Jase, Kev, 
  253. Mike-G., Paul-S., RTD, Shaunie(someone's got to support Derby County),
  254. Stephe, Stevie, U4ia, 4-mat(I'm an all-time fan of that song!)
  255.  
  256. several of whom own Amigas, though it's not really their fault.
  257.  
  258.  ______________________
  259. / Contact the author! /
  260. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  261. I'd like to hear from you whether you've found a bug, can suggest any
  262. improvements or just plain like the program. I'd especially apreciate
  263. it if you could send me a postcard! I'll try to reply to any mail I
  264. get.
  265.  
  266. By email...
  267.  
  268. Probably the best address is   D.Oakley-SE1@cs.bham.ac.uk
  269. or try                         D.Oakley%uk.ac.icl.wins.kid0112@pipex.co.uk
  270.  
  271. or send your mail to:          u2e32@uk.ac.kl.seq1
  272.  
  273. if you're sending mail from abroad you may need to go via a gateway.
  274. Ask your system administrator for info.
  275.  
  276.  
  277. By post...                      or
  278.  
  279. David Oakley                    Graham Harrison
  280. 6 Watlands Road                 353 Heathcote Road
  281. Bignall End                     Halmerend
  282. Stoke On Trent ST7 8QQ          Stoke On Trent ST7 8BH
  283. England                         England
  284.  
  285.   ___________________
  286.  / This program is  /
  287. /    SHAREWARE!    /
  288. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  289. DeskTracker has taken a lot of work by an overstressed university student!
  290. If you like this program, please do send a donation. If it is £5 UK sterling
  291. or more, I will send you the latest version of DeskTracker, plus some other
  292. ASTRAsoft things. Please don't expect an immediate reply though!
  293.  
  294. Also if you register, I'll send details of how to use the Trak player in 
  295. your own C (or possibly GFA if I get round to it) programs!
  296.  
  297. Please make all cheques payable to David Oakley and in sterling only. When
  298. registering please state which model of Atari you have and which monitor
  299. you use. ASTRAsoft do quite a few mono only things, so do mention it.
  300.  
  301.   ________________
  302.  / Warranty Free /
  303.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  304. Sorry, but this software comes with absolutely no warranty, other than 
  305. that enforced by law in your country. ASTRAsoft takes no responsability 
  306. as to the suitability of use of this software on your system or in your 
  307. particular circumstances.
  308.  
  309. The author is not responsible for any damages that may occur as a result 
  310. of use or missuse of this software, or inaccuracies in this manual.
  311.  
  312.   _________________________
  313.  / A Note to Distributors /
  314.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  315. Please do not include this disk on any Public Domain/Shareware library 
  316. disk without the explicit permission of ASTRAsoft. We like to ensure that 
  317. libraries have the most up-to-date versions of our products and so if you 
  318. let one of us know we'll send you the latest versions as they come out. 
  319. Send a letter by post or email explaining who you are, what your address 
  320. is and which products you have got at the moment. We will then send you a 
  321. reply by either of these means... once that has happened you can put it 
  322. on a disk!
  323.  
  324. Formally, DeskTracker or any other ASTRAsoft SHAREWARE product may not be 
  325. included on any PD/shareware library disk or magazine cover disk without 
  326. the permission of the ASTRAsoft partnership.
  327.  
  328.  
  329. See ya!
  330.  
  331. David.
  332.  
  333.